.\"
.\" This file and its contents are supplied under the terms of the
.\" Common Development and Distribution License ("CDDL"), version 1.0.
.\" You may only use this file in accordance with the terms of version
.\" 1.0 of the CDDL.
.\"
.\" A full copy of the text of the CDDL should have accompanied this
.\" source.  A copy of the CDDL is also available via the Internet at
.\" http://www.illumos.org/license/CDDL.
.\"
.\"
.\" Copyright 2015 Joyent, Inc.
.\" Copyright (c) 2019 Carlos Neira <cneirabustos@gmail.com>
.\" Copyright 2019 OmniOS Community Edition (OmniOSce) Association.
.\"
.Dd November 27, 2023
.Dt PROC_FLTNAME 3PROC
.Os
.Sh NAME
.Nm proc_fltname ,
.Nm proc_signame ,
.Nm proc_sysname ,
.Nm proc_dmodelname
.Nd convert a fault, signal, system call and data model to a name
.Sh LIBRARY
.Lb libproc
.Sh SYNOPSIS
.In libproc.h
.Ft "char *"
.Fo proc_fltname
.Fa "int flt"
.Fa "char *buf"
.Fa "size_t bufsz"
.Fc
.Ft "char *"
.Fo proc_signame
.Fa "int sig"
.Fa "char *buf"
.Fa "size_t bufsz"
.Fc
.Ft "char *"
.Fo proc_sysname
.Fa "int sys"
.Fa "char *buf"
.Fa "size_t bufsz"
.Fc
.Ft "char *"
.Fo proc_dmodelname
.Fa "int dmodel"
.Fa "char *buf"
.Fa "size_t bufsz"
.Fc
.Sh DESCRIPTION
The
.Fn proc_fltname ,
.Fn proc_signame ,
.Fn proc_sysname
and
.Fn proc_dmodelname
functions respectively convert the fault, signal, system call and data model in
.Fa flt ,
.Fa sig ,
.Fa sys
and
.Fa dmodel
to a human-readable name and place the corresponding string in
.Fa buf .
Up to
.Fa bufsz
characters, including the null terminator, will be written into
.Fa buf .
.Sh RETURN VALUES
Upon successful completion, the
.Fn proc_fltname ,
.Fn proc_signame ,
.Fn proc_sysname
and
.Fn proc_dmodelname
functions return a pointer to
.Fa buf .
The contents of
.Fa buf
are always null terminated.
Otherwise,
.Dv NULL
is returned.
.Sh INTERFACE STABILITY
.Sy Uncommitted
.Sh MT-LEVEL
.Sy MT-Safe
.Sh SEE ALSO
.Xr libproc 3LIB ,
.Xr proc_fltset2str 3PROC ,
.Xr proc_sigset2str 3PROC ,
.Xr proc_str2flt 3PROC ,
.Xr proc_str2fltset 3PROC ,
.Xr proc_str2sig 3PROC ,
.Xr proc_str2sigset 3PROC ,
.Xr proc_str2sys 3PROC ,
.Xr proc_str2sysset 3PROC ,
.Xr proc_sysset2str 3PROC ,
.Xr proc 5
